7.3.2 限られた量のデジタル通貨 (販売者が定義する為替レート) でスキャンコード支払い注文を作成する

#簡単な説明: デジタル通貨リチャージビジネスインターフェイス。ユーザーは QR コードをスキャンすることで USDT (テザー) をデジタルウォレットアカウントにリチャージできます (販売者のカスタマイズされた為替レート、販売者のバックエンド設定にログインする必要があります)

リクエスト方法：POST
リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/receive/blockchain/fixed/custom/rate/create ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json

リクエストパラメータ

パラメータ名	タイプ	必須	パラメータの意味	パラメータの説明
`key`	`string`	はい	販売者キー	APIキー
`localOrderId`	`string`	はい	販売者プラットフォームのローカル注文番号	販売者プラットフォームはローカルで一意の注文番号を生成します。
`localUserId`	`string`	いいえ	販売者プラットフォームのローカルユーザー ID	販売者プラットフォームのローカルユーザー ID
`notifyUrl`	`string`	いいえ	コールバックアドレス	注文が正常に完了すると、販売者のアドレスが API コールバックによって通知されます (コールバックの詳細は下部にあります)。
`successRedirectUrl`	`string`	いいえ	ジャンプアドレス	成功後に自動的にアドレスにジャンプします。
`userCurrency`	`string`	はい	通貨	ユーザーが支払う必要がある通貨 (ウォレットはデジタル通貨をサポートしています)
`quoteCurrency`	`string`	はい	カスタマイズされた見積通貨	カスタマイズされた見積通貨 (見積通貨の為替レートを設定するには、マーチャントのバックエンドにログインする必要があります)
`quoteAmount`	`number`	はい	カスタム見積り金額	注文価格金額
`isBlockchain`	`boolean`	いいえ	ブロックチェーン情報を返すかどうか (デフォルトは false)	true の場合、コールバックリクエストは注文チェーン上のトランザクション情報を伝達します。
`networkLimits`	`array`	いいえ	メインネット	TRON、BSC、POLYGON、ETHEREUM などの指定された決済メインネット
`expireSecond`	`Long`	いいえ	有効期限のタイムスタンプ (秒)
`sign`	`string`	はい	署名	詳細については、「署名アルゴリズム」を参照してください。

JSON サンプルをリクエスト

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "CONANTEST01140",
  "userCurrency": "USDT",
  "quoteCurrency": "CNY",
  "quoteAmount": "20",
  "networkLimits": ["TRON", "BSC"],
  "sign": "401c6541a4ba99794981233794f29a56"
}

応答 json の例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 474108977750213,
    "localUserId": null,
    "localOrderId": "CONANTEST01140",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
    "paymentUrl": "https://dxpay.dxstudio.org/fixed-amount-pay/JhpkZduKiBYPyn3WhobAWJnzwLMmvWxGwqrBFTRRDBf6VX7UUJeqL52ERxX6",
    "publicKey": "JhpkZduKiBYPyn3WhobAWJnzwLMmvWxGwqrBFTRRDBf6VX7UUJeqL52ERxX6",
    "currency": "CNY",
    "userCurrency": "USDT",
    "amount": "20",
    "userReceivableAmount": "1.83",
    "rate": "10.9",
    "rateExpression": "1USDT≈10.9CNY"
  }
}

返されたpaymentUrlにより、以下に示すように支払いページがポップアップ表示されます。 ![img](/dx-docs/7- 7、数字币代收（充值）/7.3 数字币限定金额扫码支付/CustomizeUsdt.jpg)

データパラメータの説明

パラメータ名	タイプ	パラメータの意味	パラメータの説明
`orderId`	`string`	注文ID
`localUserId`	`string`	販売者のローカルユーザー ID
`localOrderId`	`string`	販売者のローカル注文番号
`orderType`	`enum`	注文タイプ
`orderBizType`	`enum`	受注業態	orderBizType タイプの説明は次のとおりです。
`paymentUrl`	`string`	支払い先住所
`publicKey`	`string`	キー	パブリックアクセスキー
`currency`	`string`	注文通貨
`userCurrency`	`string`	ユーザー支払い通貨
`amount`	`string`	注文金額
`userReceivableAmount`	`string`	ユーザーが支払う金額
`rate`	`string`	為替レート
`rateExpression`	`string`	注文為替レート式

orderBizType タイプの説明:

PAYMENT_WALLET_SCAN MINPAYウォレットスキャンコード支払い
PAYMENT_TRANSFER デジタル通貨バインディングアドレス直接入金
PAYMENT_ANY_DIGITAL_SCAN QR コードをスキャンして、任意の金額のデジタル通貨を支払います
WITHDRAW_WALLET MINPAY ウォレットにお金を引き出します
WITHDRAW_ANY_DIGITAL_WALLET デジタル通貨を任意のウォレットに引き出します
PAYMENT_FIXED_DIGITAL_SCAN デジタル通貨限定金額スキャンコード支払い
BATCH_PAY 一括支払い

コールバックの詳細

コールバックメソッドは次のとおりです: POST application/json

コールバックパラメータのjson化の例

{
  "amount": 1,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "USDT",
  "extra": {
    "quoteAmount": 10,
    "quoteCurrency": "CNY",
    "quotePrice": 10
  },
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 22.72,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 7.33,
  "notifyTime": 1736744168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "WITHDRAW",
  "userAmount": 1,
  "userCurrency": "USDT",
  "userReceivableAmount": 1
}

パラメータ名	タイプ	参加署名	パラメータの意味	パラメータの説明
`amount`	`decimal`	はい	注文金額
`bizType`	`enum`	はい	注文タイプ
`blockchain`	`object`	はい	チェーントランザクション情報	オーダーリクエストパラメータ isBlockchain が true の場合、コールバックリクエストはこのオブジェクト情報を伝えます。 (オンチェーントランザクションのみが関係する場合、isBlockchain パラメータが有効になります)
└ネットワーク	`String`	はい	メインネット
└受信者アドレス	`String`	はい	受信者のアドレス
└差出人住所	`decimal`	はい	送付先住所
└txId	`String`	はい	トランザクションID
`currency`	`String`	はい	通貨
`key`	`String`	はい	販売者キー
`localOrderId`	`String`	はい	ローカル注文番号
`merchantActualAmount`	`decimal`	はい	販売者の実際の支払い額
`merchantCurrency`	`String`	はい	販売者の支払い通貨	デフォルトの通貨
`merchantId`	`String`	はい	販売者 ID
`merchantPaidAmount`	`decimal`	はい	販売者の支払額
`merchantUserId`	`String`	はい	ユーザーID
`notifyTime`	`long`	はい	コールバック時間
`orderCreateTime`	`long`	はい	注文作成時間
`orderId`	`String`	はい	注文番号
`status`	`String`	はい	支払い状況
`type`	`String`	はい	注文タイプ
`userAmount`	`decimal`	はい	ユーザー支払額
`userCurrency`	`String`	はい	ユーザー支払い通貨
`sign`	`String`	いいえ	md5署名	詳細については、署名アルゴリズムを参照してください。
`extra`	`object`	はい	次のパラメータが含まれます。
└見積金額	`number`	はい	注文見積金額
└見積通貨	`number`	はい	注文見積通貨
└お見積り価格	`string`	はい	注文見積価格
`userReceivableAmount`	`string`	はい	ユーザーが支払う金額

コールバック通知を受信した場合は、処理が完了した後、メッセージが正常に受信され処理されたことを示す文字列 success を直接返してください。システムが成功応答を受信すると、コールバックを繰り返し送信しなくなります。予期した応答が受信されない場合 (成功が返されないか、例外が返された場合)、システムは段階的再試行メカニズムに従ってコールバック通知を再送信し、最大 14 回再試行します。現在の再試行間隔は次のとおりです。 15秒、15秒、30秒、180秒、600秒、1200秒、1800秒、1800秒、1800秒、3600秒、10800秒、10800秒、21600秒、21600秒

リクエストパラメータ​

JSON サンプルをリクエスト​

データパラメータの説明​

orderBizType タイプの説明:​

コールバックの詳細​

コールバック メソッドは次のとおりです: POST application/json​

コールバックパラメータのjson化の例​